home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / wincap.zip / README.TXT < prev    next >
Text File  |  1991-11-05  |  5KB  |  114 lines
  1. Windows Screen Capture Sample Application
  2. -----------------------------------------
  3.  
  4. DESCRIPTION:
  5. ------------
  6.  
  7. Captures portions of the screen, specific windows, or the entire
  8. screen and saves it to a file or prints it.  Uses DIBAPI functions to
  9. do most of the capture/printing/saving work.  See the file DIBAPI.TXT
  10. for a description of the DIB api functions.
  11.  
  12. This sample is an illustration of the following Windows techniques:
  13.  
  14.     - Capturing the screen (or a specific window) into a DIB
  15.     - Capturing the screen to a Bitmap (device-dependent bitmap)
  16.     - Printing a DIB using banding
  17.     - Loading and Saving a DIB to a disk file (.BMP file)
  18.  
  19. All of these are accomplished with calls to a simple-to-use DIB API.
  20. The DIB API provides the following functions:
  21.  
  22. PrintWindow()       - Prints all or part of a window
  23. PrintScreen()       - Prints the entire screen
  24. CopyWindowToDIB()   - Copies a window to a DIB
  25. CopyScreenToDIB()   - Copies entire screen to a DIB
  26. CopyWindowToBitmap()- Copies a window to a standard Bitmap
  27. CopyScreenToBitmap()- Copies entire screen to a standard Bitmap
  28. PrintDIB()          - Prints the specified DIB
  29. SaveDIB()           - Saves the specified dib in a file
  30. LoadDIB()           - Loads a DIB from a file
  31. DestroyDIB()        - Deletes DIB when finished using it
  32.  
  33. The source code to these functions are included in this sample.  You
  34. can easily call these functions from a different application by
  35. simply including the proper source files and linking them to your
  36. application.  The file DIBAPI.TXT contains more documentation on
  37. these functions.
  38.  
  39. The source files for the DIB API are as follows:
  40.  
  41.     file.c    - SaveDIB, LoadDIB, and DestroyDIB
  42.     print.c   - PrintDIB, PrintWindow, and PrintScreen
  43.     copy.c    - CopyWindowToDIB, CopyScreenToDIB, CopyWindowToBitmap,
  44.                 CopyScreenToBitmap
  45.     dibapi.h  - header file which contains prototypes for the DIB
  46.                 API functions
  47.     dibutil.c - Utility functions
  48.     errors.c  - Defines all errors which can be returned from DIB
  49.                 API functions
  50.     errors.h  - Defines constants for all errors
  51.  
  52. Other files:
  53.  
  54.     dialogs.c - Contains dialog routines for dialog boxes in WinCap
  55.     wincap.c  - Contains WinMain - this is the main program file for
  56.                 the WinCap sample
  57.     makefile  - Makefile for WinCap
  58.  
  59. CREDITS:
  60. --------
  61.  
  62. Development Team: Mark Bader
  63.                   Patrick Schreiber
  64.                   Garrett McAuliffe
  65.                   Eric Flo
  66.                   Tony Claflin
  67.  
  68. Written by Microsoft Product Support Services, Developer Support.
  69.  
  70.  
  71. COPYRIGHT NOTICE
  72. ----------------
  73.  
  74. THE INFORMATION AND CODE PROVIDED HEREUNDER (COLLECTIVELY REFERRED TO
  75. AS "SOFTWARE") IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER
  76. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
  77. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN
  78. NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
  79. ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
  80. CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
  81. MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
  82. POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR
  83. LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE
  84. FOREGOING LIMITATION MAY NOT APPLY.
  85.  
  86. This Software may be copied and distributed royalty-free subject to
  87. the following conditions:
  88.  
  89. 1. You must copy all Software without modification and must include
  90.    all pages, if the Software is distributed without inclusion in your
  91.    software product. If you are incorporating the Software in
  92.    conjunction with and as a part of your software product which adds
  93.    substantial value, you may modify and include portions of the
  94.    Software.
  95.  
  96. 2. You must place all copyright notices and other protective
  97.    disclaimers and notices contained on the Software on all copies of
  98.    the Software and your software product.
  99.  
  100. 3. Unless the Software is incorporated in your software product which
  101.    adds substantial value, you may not distribute this Software for
  102.    profit.
  103.  
  104. 4. You may not use Microsoft's name, logo, or trademarks to market
  105.    your software product.
  106.  
  107. 5. You agree to indemnify, hold harmless, and defend Microsoft and its
  108.    suppliers from and against any claims or lawsuits, including
  109.    attorneys' fees, that arise or result from the use or distribution
  110.    of your software product and any modifications to the Software.
  111.  
  112. Copyright (c) 1991 Microsoft Corporation. All rights reserved.
  113.  
  114.